home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / OpenGL / glrasterpos.z / glrasterpos
Encoding:
Text File  |  2001-04-17  |  17.1 KB  |  199 lines
  1.  
  2.  
  3.  
  4. ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss((((3333GGGG))))                OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss2222dddd,,,, ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss2222ffff,,,, ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss2222iiii,,,, ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss2222ssss,,,,
  10.      ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss3333dddd,,,, ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss3333ffff,,,, ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss3333iiii,,,, ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss3333ssss,,,,
  11.      ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss4444dddd,,,, ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss4444ffff,,,, ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss4444iiii,,,, ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss4444ssss,,,,
  12.      ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss2222ddddvvvv,,,, ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss2222ffffvvvv,,,, ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss2222iiiivvvv,,,, ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss2222ssssvvvv,,,,
  13.      ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss3333ddddvvvv,,,, ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss3333ffffvvvv,,,, ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss3333iiiivvvv,,,, ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss3333ssssvvvv,,,,
  14.      ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss4444ddddvvvv,,,, ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss4444ffffvvvv,,,, ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss4444iiiivvvv,,,, ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss4444ssssvvvv - specify
  15.      the raster position for pixel operations
  16.  
  17.  
  18. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  19.      void ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss2222dddd( GLdouble _x,
  20.                          GLdouble _y )
  21.      void ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss2222ffff( GLfloat _x,
  22.                          GLfloat _y )
  23.      void ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss2222iiii( GLint _x,
  24.                          GLint _y )
  25.      void ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss2222ssss( GLshort _x,
  26.                          GLshort _y )
  27.      void ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss3333dddd( GLdouble _x,
  28.                          GLdouble _y,
  29.                          GLdouble _z )
  30.      void ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss3333ffff( GLfloat _x,
  31.                          GLfloat _y,
  32.                          GLfloat _z )
  33.      void ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss3333iiii( GLint _x,
  34.                          GLint _y,
  35.                          GLint _z )
  36.      void ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss3333ssss( GLshort _x,
  37.                          GLshort _y,
  38.                          GLshort _z )
  39.      void ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss4444dddd( GLdouble _x,
  40.                          GLdouble _y,
  41.                          GLdouble _z,
  42.                          GLdouble _w )
  43.      void ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss4444ffff( GLfloat _x,
  44.                          GLfloat _y,
  45.                          GLfloat _z,
  46.                          GLfloat _w )
  47.      void ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss4444iiii( GLint _x,
  48.                          GLint _y,
  49.                          GLint _z,
  50.                          GLint _w )
  51.      void ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss4444ssss( GLshort _x,
  52.                          GLshort _y,
  53.                          GLshort _z,
  54.                          GLshort _w )
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss((((3333GGGG))))                OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss((((3333GGGG))))
  71.  
  72.  
  73.  
  74. PARAMETERS
  75.      _x, _y, _z, _w
  76.               Specify the x, y, z, and w object coordinates (if present) for
  77.               the raster position.
  78.  
  79. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  80.      void ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss2222ddddvvvv( const GLdouble *_v )
  81.      void ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss2222ffffvvvv( const GLfloat *_v )
  82.      void ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss2222iiiivvvv( const GLint *_v )
  83.      void ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss2222ssssvvvv( const GLshort *_v )
  84.      void ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss3333ddddvvvv( const GLdouble *_v )
  85.      void ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss3333ffffvvvv( const GLfloat *_v )
  86.      void ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss3333iiiivvvv( const GLint *_v )
  87.      void ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss3333ssssvvvv( const GLshort *_v )
  88.      void ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss4444ddddvvvv( const GLdouble *_v )
  89.      void ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss4444ffffvvvv( const GLfloat *_v )
  90.      void ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss4444iiiivvvv( const GLint *_v )
  91.      void ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss4444ssssvvvv( const GLshort *_v )
  92.  
  93.  
  94. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  95.      _v    Specifies a pointer to an array of two, three, or four elements,
  96.           specifying x, y, z, and w coordinates, respectively.
  97.  
  98. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  99.      The GL maintains a 3D position in window coordinates.  This position,
  100.      called the raster position, is used to position pixel and bitmap write
  101.      operations. It is maintained with subpixel accuracy.  See ggggllllBBBBiiiittttmmmmaaaapppp,
  102.      ggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss, and ggggllllCCCCooooppppyyyyPPPPiiiixxxxeeeellllssss.
  103.  
  104.      The current raster position consists of three window coordinates (x, y,
  105.      z), a clip coordinate value (w), an eye coordinate distance, a valid bit,
  106.      and associated color data and texture coordinates.  The w coordinate is a
  107.      clip coordinate, because w is not projected to window coordinates.
  108.      ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss4444 specifies object coordinates x, y, z, and w explicitly.
  109.      ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss3333 specifies object coordinate x, y, and z explicitly, while w
  110.      is implicitly set to 1.  ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss2222 uses the argument values for x and
  111.      y while implicitly setting z and w to 0 and 1.
  112.  
  113.      The object coordinates presented by ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss are treated just like
  114.      those of a ggggllllVVVVeeeerrrrtttteeeexxxx command:  They are transformed by the current
  115.      modelview and projection matrices and passed to the clipping stage.  If
  116.      the vertex is not culled, then it is projected and scaled to window
  117.      coordinates, which become the new current raster position, and the
  118.      GGGGLLLL____CCCCUUUURRRRRRRREEEENNNNTTTT____RRRRAAAASSSSTTTTEEEERRRR____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN____VVVVAAAALLLLIIIIDDDD flag is set.  If the vertex _i_s culled,
  119.      then the valid bit is cleared and the current raster position and
  120.      associated color and texture coordinates are undefined.
  121.  
  122.      The current raster position also includes some associated color data and
  123.      texture coordinates.  If lighting is enabled, then
  124.      GGGGLLLL____CCCCUUUURRRRRRRREEEENNNNTTTT____RRRRAAAASSSSTTTTEEEERRRR____CCCCOOOOLLLLOOOORRRR (in RGBA mode) or GGGGLLLL____CCCCUUUURRRRRRRREEEENNNNTTTT____RRRRAAAASSSSTTTTEEEERRRR____IIIINNNNDDDDEEEEXXXX (in
  125.      color index mode) is set to the color produced by the lighting
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss((((3333GGGG))))                OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss((((3333GGGG))))
  137.  
  138.  
  139.  
  140.      calculation (see ggggllllLLLLiiiigggghhhhtttt, ggggllllLLLLiiiigggghhhhttttMMMMooooddddeeeellll, and
  141.      ggggllllSSSShhhhaaaaddddeeeeMMMMooooddddeeeellll).  If lighting is disabled, current color (in RGBA mode,
  142.      state variable GGGGLLLL____CCCCUUUURRRRRRRREEEENNNNTTTT____CCCCOOOOLLLLOOOORRRR) or color index (in color index mode,
  143.      state variable GGGGLLLL____CCCCUUUURRRRRRRREEEENNNNTTTT____IIIINNNNDDDDEEEEXXXX) is used to update the current raster
  144.      color.
  145.  
  146.      Likewise, GGGGLLLL____CCCCUUUURRRRRRRREEEENNNNTTTT____RRRRAAAASSSSTTTTEEEERRRR____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOOOOORRRRDDDDSSSS is updated as a function of
  147.      GGGGLLLL____CCCCUUUURRRRRRRREEEENNNNTTTT____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOOOOORRRRDDDDSSSS, based on the texture matrix and the texture
  148.      generation functions (see ggggllllTTTTeeeexxxxGGGGeeeennnn).  Finally, the distance from the
  149.      origin of the eye coordinate system to the vertex as transformed by only
  150.      the modelview matrix replaces GGGGLLLL____CCCCUUUURRRRRRRREEEENNNNTTTT____RRRRAAAASSSSTTTTEEEERRRR____DDDDIIIISSSSTTTTAAAANNNNCCCCEEEE.
  151.  
  152.      Initially, the current raster position is (0, 0, 0, 1), the current
  153.      raster distance is 0, the valid bit is set, the associated RGBA color is
  154.      (1, 1, 1, 1), the associated color index is 1, and the associated texture
  155.      coordinates are (0, 0, 0, 1).  In RGBA mode, GGGGLLLL____CCCCUUUURRRRRRRREEEENNNNTTTT____RRRRAAAASSSSTTTTEEEERRRR____IIIINNNNDDDDEEEEXXXX is
  156.      always 1; in color index mode, the current raster RGBA color always
  157.      maintains its initial value.
  158.  
  159. NNNNOOOOTTTTEEEESSSS
  160.      The raster position is modified both by ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss and by ggggllllBBBBiiiittttmmmmaaaapppp.
  161.  
  162.      When the raster position coordinates are invalid, drawing commands that
  163.      are based on the raster position are ignored (that is, they do not result
  164.      in changes to GL state).
  165.  
  166.      Calling ggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss, or ggggllllDDDDrrrraaaawwwwRRRRaaaannnnggggeeeeEEEElllleeeemmmmeeeennnnttttssss may leave the current
  167.      color or index indeterminate.  If ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss is executed while the
  168.      current color or index is indeterminate, the current raster color or
  169.      current raster index remains indeterminate.
  170.  
  171.      To set a valid raster position outside the viewport, first set a valid
  172.      raster position, then call ggggllllBBBBiiiittttmmmmaaaapppp with NULL as the _b_i_t_m_a_p parameter.
  173.  
  174. EEEERRRRRRRROOOORRRRSSSS
  175.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ggggllllRRRRaaaasssstttteeeerrrrPPPPoooossss is executed between the
  176.      execution of ggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of ggggllllEEEEnnnndddd.
  177.  
  178. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  179.      ggggllllGGGGeeeetttt with argument GGGGLLLL____CCCCUUUURRRRRRRREEEENNNNTTTT____RRRRAAAASSSSTTTTEEEERRRR____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN
  180.      ggggllllGGGGeeeetttt with argument GGGGLLLL____CCCCUUUURRRRRRRREEEENNNNTTTT____RRRRAAAASSSSTTTTEEEERRRR____PPPPOOOOSSSSIIIITTTTIIIIOOOONNNN____VVVVAAAALLLLIIIIDDDD
  181.      ggggllllGGGGeeeetttt with argument GGGGLLLL____CCCCUUUURRRRRRRREEEENNNNTTTT____RRRRAAAASSSSTTTTEEEERRRR____DDDDIIIISSSSTTTTAAAANNNNCCCCEEEE
  182.      ggggllllGGGGeeeetttt with argument GGGGLLLL____CCCCUUUURRRRRRRREEEENNNNTTTT____RRRRAAAASSSSTTTTEEEERRRR____CCCCOOOOLLLLOOOORRRR
  183.      ggggllllGGGGeeeetttt with argument GGGGLLLL____CCCCUUUURRRRRRRREEEENNNNTTTT____RRRRAAAASSSSTTTTEEEERRRR____IIIINNNNDDDDEEEEXXXX
  184.      ggggllllGGGGeeeetttt with argument GGGGLLLL____CCCCUUUURRRRRRRREEEENNNNTTTT____RRRRAAAASSSSTTTTEEEERRRR____TTTTEEEEXXXXTTTTUUUURRRREEEE____CCCCOOOOOOOORRRRDDDDSSSS
  185.  
  186.  
  187. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  188.      ggggllllBBBBiiiittttmmmmaaaapppp, ggggllllCCCCooooppppyyyyPPPPiiiixxxxeeeellllssss, ggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss, ggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss,
  189.      ggggllllDDDDrrrraaaawwwwRRRRaaaannnnggggeeeeEEEElllleeeemmmmeeeennnnttttssss, ggggllllDDDDrrrraaaawwwwPPPPiiiixxxxeeeellllssss, ggggllllLLLLiiiigggghhhhtttt, ggggllllLLLLiiiigggghhhhttttMMMMooooddddeeeellll, ggggllllSSSShhhhaaaaddddeeeeMMMMooooddddeeeellll,
  190.      ggggllllTTTTeeeexxxxCCCCoooooooorrrrdddd, ggggllllTTTTeeeexxxxGGGGeeeennnn, ggggllllVVVVeeeerrrrtttteeeexxxx
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.